8. Template URLs

In some cases, it may be useful for a client to understand the structure of the read URLs. One such example is a CalDAV server that publishes Freebusy data for an entire group of users.

Template URLs are defined in a draft specification available at URI-Templates. A client can request a read template URL that the client can then use to create normal, i.e. non template, URLs for different users on the same Freebusy server. The following table defines those keys clients must understand to successfully build a URL from a template.

Template Key

Meaning

userid

The full userid such as “mailto:user1@example.com

user

A userid without a domain, such as “user1”

domain

The domain part of a userid, such as “example.com”

token

An auth token that identifies the requesting user.